<!doctype html>
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
  <head>
    <meta charset="utf-8" />
    <meta name="generator" content="pandoc" />
    <meta
      name="viewport"
      content="width=device-width, initial-scale=1.0, user-scalable=yes"
    />
    <title>Release Notes for STM32WLxx HAL Drivers Package</title>
    <style type="text/css">
      code {
        white-space: pre-wrap;
      }
      span.smallcaps {
        font-variant: small-caps;
      }
      span.underline {
        text-decoration: underline;
      }
      div.column {
        display: inline-block;
        vertical-align: top;
        width: 50%;
      }
    </style>
    <link rel="stylesheet" href="_htmresc/mini-st.css" />
    <!--[if lt IE 9]>
      <script src="//cdnjs.cloudflare.com/ajax/libs/html5shiv/3.7.3/html5shiv-printshiv.min.js"></script>
    <![endif]-->
  </head>
  <body>
    <div class="row">
      <div class="col-sm-12 col-lg-4">
        <div class="card fluid">
          <div class="sectione dark">
            <center>
              <h1 id="release-notes-forstm32wlxx-hal-drivers">
                <small>Release Notes for</small
                ><mark>STM32WLxx HAL Drivers</mark>
              </h1>
              <p>Copyright © 2019 STMicroelectronics</p>
              <a href="https://www.st.com" class="logo"
                ><img src="_htmresc/st_logo.png" alt="ST logo"
              /></a>
            </center>
          </div>
        </div>
        <h1 id="license">License</h1>
        <p>
          This software component is licensed by ST under BSD-3-Clause license,
          the “License”; You may not use this component except in compliance
          with the License. You may obtain a copy of the License at:
        </p>
        <p>
          <a href="https://opensource.org/licenses/BSD-3-Clause"
            >https://opensource.org/licenses/BSD-3-Clause</a
          >
        </p>
        <h1 id="purpose">Purpose</h1>
        <p>
          The STM32Cube HAL and LL, an STM32 abstraction layer embedded
          software, ensure maximized portability across STM32 portfolio.
        </p>
        <p>
          The Portable APIs layer provides a generic, multi instanced and simple
          set of APIs to interact with the upper layer (application, libraries
          and stacks). It is composed of native and extended APIs set. It is
          directly built around a generic architecture and allows the build-upon
          layers, like the middleware layer, to implement its functions without
          knowing in-depth the used STM32 device. This improves the library code
          reusability and guarantees an easy portability on other devices and
          STM32 families.
        </p>
        <p>
          The Low Layer (LL) drivers are part of the STM32Cube firmware HAL that
          provide basic set of optimized and one shot services. The Low layer
          drivers, contrary to the HAL ones are not Fully Portable across the
          STM32 families; the availability of some functions depend on the
          physical availability of the relative features on the product. The Low
          Layer (LL) drivers are designed to offer the following features:
        </p>
        <ul>
          <li>
            New set of inline function for direct and atomic register access
          </li>
          <li>
            One-shot operations that can be used by the HAL drivers or from
            application level.
          </li>
          <li>
            Fully Independant from HAL and can be used in standalone usage
            (without HAL drivers)
          </li>
          <li>Full features coverage of the all the supported peripherals.</li>
        </ul>
      </div>
      <div class="col-sm-12 col-lg-8">
        <h1 id="update-history">Update History</h1>
        <div class="collapse">
          <input
            type="checkbox"
            id="collapse-section6"
            checked
            aria-hidden="true"
          />
          <label for="collapse-section6" aria-hidden="true"
            ><strong>V0.4.0 / 13-December-2019</strong></label
          >
          <div>
            <h2 id="main-changes">Main Changes</h2>
            <h3 id="fourth-alpha-release-used-for-oem-announcement">
              Fourth Alpha release (Used for OEM announcement)
            </h3>
            <p>
              Full LL &amp; HAL Drivers fully compliant with MISRA C 2012 and
              Code Sonar
            </p>
            <h2 id="development-toolchains-and-compilers">
              Development Toolchains and Compilers
            </h2>
            <ul>
              <li>IAR Embedded Workbench for ARM (EWARM) toolchain V8.30.1</li>
              <li>
                RealView Microcontroller Development Kit (MDK-ARM) toolchain
                V5.25
              </li>
            </ul>
            <h2 id="supported-devices-and-boards">
              Supported Devices and boards
            </h2>
            <p>Supported Devices:</p>
            <ul>
              <li>STM32WLE5xx</li>
            </ul>
            <h2 id="backward-compatibility">Backward Compatibility</h2>
            <p>This release is compatible with the previous versions.</p>
            <h2 id="dependencies">Dependencies</h2>
            <p>None</p>
            <h2 id="known-limitations">Known Limitations</h2>
            <table>
              <caption>
                Outstanding bugs list
              </caption>
              <thead>
                <tr class="header">
                  <th style="text-align: left">Ticket</th>
                  <th style="text-align: left">Headline</th>
                </tr>
              </thead>
              <tbody>
                <tr class="odd">
                  <td style="text-align: left">
                    <a href="https://intbugzilla.st.com/show_bug.cgi?id=66617"
                      >66617</a
                    >
                  </td>
                  <td style="text-align: left">
                    HAL_RTC_AlarmIRQHandler() shall not clear no matter which
                    pending bit in dual core
                  </td>
                </tr>
                <tr class="even">
                  <td style="text-align: left">
                    <a href="https://intbugzilla.st.com/show_bug.cgi?id=77533"
                      >77533</a
                    >
                  </td>
                  <td style="text-align: left">
                    [I2C_HAL] Incorrectly enable interrupts in I2C_Enable_IRQ
                    routine when InterruptRequest = I2C_XFER_CPLT_IT
                  </td>
                </tr>
              </tbody>
            </table>
            <p><br /></p>
            <table>
              <caption>
                Requirements not met or planned in a forthcoming release
              </caption>
              <thead>
                <tr class="header">
                  <th style="text-align: left">Ticket</th>
                  <th style="text-align: left">Headline</th>
                </tr>
              </thead>
              <tbody>
                <tr class="odd">
                  <td style="text-align: left">
                    <a href="https://intbugzilla.st.com/show_bug.cgi?id=72392"
                      >72392</a
                    >
                  </td>
                  <td style="text-align: left">
                    [WL] ADC value from channel TempSensor wrong at 1st read
                  </td>
                </tr>
                <tr class="even">
                  <td style="text-align: left">
                    <a href="https://intbugzilla.st.com/show_bug.cgi?id=72561"
                      >72561</a
                    >
                  </td>
                  <td style="text-align: left">
                    Align ADC naming without index like indicated in reference
                    Manual
                  </td>
                </tr>
              </tbody>
            </table>
            <p><br /></p>
          </div>
        </div>
        <div class="collapse">
          <input type="checkbox" id="collapse-section5" aria-hidden="true" />
          <label for="collapse-section5" aria-hidden="true"
            ><strong>V0.3.0 / 27-September-2019</strong></label
          >
          <div>
            <h2 id="main-changes-1">Main Changes</h2>
            <h3 id="third-alpha-release-use-for-alpha2-program">
              Third Alpha release (Use for Alpha2 program)
            </h3>
            <p>Full LL &amp; HAL Drivers including Dual Core Supported</p>
            <p>
              Note that 100% of LL &amp; HAL Drivers are fully compliant with
              MISRA C 2012 and Code Sonar
            </p>
            <h2 id="development-toolchains-and-compilers-1">
              Development Toolchains and Compilers
            </h2>
            <ul>
              <li>IAR Embedded Workbench for ARM (EWARM) toolchain V8.30.1</li>
              <li>
                RealView Microcontroller Development Kit (MDK-ARM) toolchain
                V5.25
              </li>
            </ul>
            <h2 id="supported-devices-and-boards-1">
              Supported Devices and boards
            </h2>
            <p>Supported Devices:</p>
            <ul>
              <li>STM32WL55xx</li>
              <li>STM32WL54xx</li>
              <li>STM32WLE5xx</li>
              <li>STM32WLE4xx</li>
            </ul>
            <h2 id="backward-compatibility-1">Backward Compatibility</h2>
            <p>This release is compatible with the previous versions.</p>
            <h2 id="dependencies-1">Dependencies</h2>
            <p>None</p>
            <h2 id="known-limitations-1">Known Limitations</h2>
            <table>
              <caption>
                Outstanding bugs list
              </caption>
              <thead>
                <tr class="header">
                  <th style="text-align: left">Ticket</th>
                  <th style="text-align: left">Headline</th>
                </tr>
              </thead>
              <tbody>
                <tr class="odd">
                  <td style="text-align: left">
                    <a href="https://intbugzilla.st.com/show_bug.cgi?id=66617"
                      >66617</a
                    >
                  </td>
                  <td style="text-align: left">
                    HAL_RTC_AlarmIRQHandler() shall not clear no matter which
                    pending bit in dual core
                  </td>
                </tr>
                <tr class="even">
                  <td style="text-align: left">
                    <a href="https://intbugzilla.st.com/show_bug.cgi?id=71720"
                      >71720</a
                    >
                  </td>
                  <td style="text-align: left">
                    [PKA_HAL][MISRAC2012-Rule-2.4] Tag `__PKA_HandleTypeDef’ is
                    unused
                  </td>
                </tr>
              </tbody>
            </table>
            <p><br /></p>
            <table>
              <caption>
                Requirements not met or planned in a forthcoming release
              </caption>
              <thead>
                <tr class="header">
                  <th style="text-align: left">Ticket</th>
                  <th style="text-align: left">Headline</th>
                </tr>
              </thead>
              <tbody>
                <tr class="odd">
                  <td style="text-align: left">
                    <a href="https://intbugzilla.st.com/show_bug.cgi?id=72357"
                      >72357</a
                    >
                  </td>
                  <td style="text-align: left">
                    [WL/CRYP] AES GCM, IV and KEY input parameter format has to
                    be updated
                  </td>
                </tr>
                <tr class="even">
                  <td style="text-align: left">
                    <a href="https://intbugzilla.st.com/show_bug.cgi?id=72358"
                      >72358</a
                    >
                  </td>
                  <td style="text-align: left">
                    [WL/CRYP] AES GCM: handling of ADD with size not multiple of
                    4 bytes
                  </td>
                </tr>
                <tr class="odd">
                  <td style="text-align: left">
                    <a href="https://intbugzilla.st.com/show_bug.cgi?id=72366"
                      >72366</a
                    >
                  </td>
                  <td style="text-align: left">
                    [WL/CRYP] AES GCM: Need to support data encrypt/decrypt with
                    length not multiple of 16 bytes
                  </td>
                </tr>
                <tr class="even">
                  <td style="text-align: left">
                    <a href="https://intbugzilla.st.com/show_bug.cgi?id=72392"
                      >72392</a
                    >
                  </td>
                  <td style="text-align: left">
                    [WL] ADC value from channel TempSensor wrong at 1st read
                  </td>
                </tr>
                <tr class="odd">
                  <td style="text-align: left">
                    <a href="https://intbugzilla.st.com/show_bug.cgi?id=72557"
                      >72557</a
                    >
                  </td>
                  <td style="text-align: left">
                    Need to rename AES1 to AES to be in line with Reference
                    Manual &amp; CubeMx
                  </td>
                </tr>
                <tr class="even">
                  <td style="text-align: left">
                    <a href="https://intbugzilla.st.com/show_bug.cgi?id=72561"
                      >72561</a
                    >
                  </td>
                  <td style="text-align: left">
                    Align ADC naming without index like indicated in reference
                    Manual
                  </td>
                </tr>
                <tr class="odd">
                  <td style="text-align: left">
                    <a href="https://intbugzilla.st.com/show_bug.cgi?id=72563"
                      >72563</a
                    >
                  </td>
                  <td style="text-align: left">
                    Align DAC naming with Reference Manual without any index 1
                  </td>
                </tr>
              </tbody>
            </table>
            <p><br /></p>
          </div>
        </div>
        <div class="collapse">
          <input type="checkbox" id="collapse-section4" aria-hidden="true" />
          <label for="collapse-section4" aria-hidden="true"
            ><strong>V0.2.0 / 21-June-2019</strong></label
          >
          <div>
            <h2 id="main-changes-2">Main Changes</h2>
            <h3 id="second-alpha-release-use-for-alpha1-program">
              Second Alpha release (Use for Alpha1 program)
            </h3>
            <p>Update of LL &amp; HAL Drivers following Si validation phase</p>
            <h2 id="development-toolchains-and-compilers-2">
              Development Toolchains and Compilers
            </h2>
            <ul>
              <li>IAR Embedded Workbench for ARM (EWARM) toolchain V8.30.1</li>
              <li>
                RealView Microcontroller Development Kit (MDK-ARM) toolchain
                V5.25
              </li>
            </ul>
            <h2 id="supported-devices-and-boards-2">
              Supported Devices and boards
            </h2>
            <p>Supported Devices:</p>
            <ul>
              <li>STM32WL55xx</li>
            </ul>
            <h2 id="backward-compatibility-2">Backward Compatibility</h2>
            <p>This release is compatible with the previous versions.</p>
            <h2 id="dependencies-2">Dependencies</h2>
            <p>None</p>
          </div>
        </div>
        <div class="collapse">
          <input type="checkbox" id="collapse-section3" aria-hidden="true" />
          <label for="collapse-section3" aria-hidden="true"
            ><strong>V0.1.0 / 15-February-2019</strong></label
          >
          <div>
            <h2 id="main-changes-3">Main Changes</h2>
            <h3 id="first-alpha-release-for-internal-use-only">
              First Alpha release (for internal use only)
            </h3>
            <p>
              First alpha release of HAL and Low layers drivers to introduce
              support of <strong>STM32WL55xx</strong>.
            </p>
            <h2 id="development-toolchains-and-compilers-3">
              Development Toolchains and Compilers
            </h2>
            <ul>
              <li>IAR Embedded Workbench for ARM (EWARM) toolchain V8.30.1</li>
            </ul>
            <h2 id="supported-devices-and-boards-3">
              Supported Devices and boards
            </h2>
            <p>Supported Devices:</p>
            <ul>
              <li>STM32WL55xx</li>
            </ul>
            <h2 id="backward-compatibility-3">Backward Compatibility</h2>
            <p>None ## Dependencies</p>
            <p>None</p>
          </div>
        </div>
      </div>
    </div>
    <footer class="sticky">
      <p>
        For complete documentation on <strong>STM32 Microcontrollers</strong>,
        visit: <a href="http://www.st.com/STM32">http://www.st.com/STM32</a>
      </p>
      <p>
        This release note uses up to date web standards and, for this reason,
        should not be opened with Internet Explorer but preferably with popular
        browsers such as Google Chrome, Mozilla Firefox, Opera or Microsoft
        Edge.
      </p>
    </footer>
  </body>
</html>
